home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / datatypes / dfadt / doc / dfadt.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  10KB  |  229 lines
  1. @database DFADT.guide
  2. @Master dfadt.texinfo
  3. @Width 72
  4. This is the AmigaGuide
  5.  file DFADT.guide, produced by Makeinfo-1.55 from 
  6. the input file dfadt.texinfo.
  7. @Node Main "DFADT.guide"
  8.                    Welcome to the DFA datatype v39.1
  9. This datatype enables you to view address files created by DFA using
  10. e.g. Multiview. This datatype works completely stand alone, i.e. you
  11. don't need any other part of the DFA package on your system.
  12.          The DFA datatype is (C) 1995 Dirk Federlein, Freeware
  13. The drawer and document icons were taken from the MagicWB distribution.
  14. MagicWB was created by Martin 'XEN' Huttenloher. The icons are
  15. distributed with kind permission of the author.
  16.  @{"         Copyright        " Link "Copyright"}               Copyright notice and status
  17.  @{"         Guarantee        " Link "Guarantee"}               What I guarantee
  18.  @{"    Evolution/Overview    " Link "Evolution"}               Why did I write this datatype;
  19.                                            and what does it do?
  20.  @{"       Installation       " Link "Installation"}               How to install the DFA datatype
  21.  @{"   Needed Configuration   " Link "Config"}               Hardware and software needed
  22.                                            to use this little piece of software.
  23.  @{"  Using the DFA datatype  " Link "Usage"}               Well, how to use the DFA datatype?
  24.  @{" Customizing the datatype " Link "Customizing"}               Getting your own display format.
  25.  @{"      Note on MagicWB     " Link "MagicWB"}               You still don`t use MagicWB?
  26.  @{"          Thanks          " Link "Thanks"}               Whom I must say 'thank you'
  27.  @{"   How to obtain updates  " Link "UpDates"}               What am 'I' supposed to do
  28.  @{" How to reach the author  " Link "Address"}               This is my address
  29.  @{"        Commercial        " Link "Commercial"}               There must be more...
  30.  @{"         History          " Link "History"}               Program History
  31. @EndNode
  32. @Node "Copyright" "DFADT.guide/Copyright"
  33. @Toc "Main"
  34. Copyright
  35. *********
  36.    You are allowed to copy and spread this program but only if you do
  37. not make any commercial profit out of the program itself and all
  38. supported files. The source of the DFA datatype is considered teachware
  39. and the author claims the right to be the only one to produce and
  40. release new versions of the datatype. Public Domain vendors are not
  41. allowed to sell the DFA datatype for more than the price of a regular
  42. disk, which should not be higher than 5 Dollars.
  43.    The DFA datatype is FreeWare, so if you don't have to pay anything
  44. for it.
  45. @EndNode
  46. @Node "Guarantee" "DFADT.guide/Guarantee"
  47. @Toc "Main"
  48. Guarantee
  49. *********
  50.    The author does not give any guarantee that the DFA datatype works
  51. perfectly.  It was tested and it is used every day, anyway nobody is
  52. perfect and that is why I cannot take the responsibilty for any damages
  53. occured during the usage of the DFA datatype.
  54. @EndNode
  55. @Node "Evolution" "DFADT.guide/Evolution"
  56. @Toc "Main"
  57. Evolution/Overview
  58. ******************
  59.    For some time I've recognized that more datatypes become available
  60. every day; nearly every file format is supported by a corresponing
  61. datatype. "Wouldn't it be cool, to create such a datatype by
  62. yourself?", I asked myself and started to look for example sources.
  63.    Examples were easy to find and it took not much time to finish the
  64. DFA datatype. This datatype gives you access to files created by my
  65. address program DFA (see @{"Commercial" Link "Commercial"} for details).
  66. @EndNode
  67. @Node "Installation" "DFADT.guide/Installation"
  68. @Toc "Main"
  69. Installing the DFA datatype
  70. ***************************
  71.    Installing the DFA datatype is not that hard. Simply copy the files
  72. @{b}DFA@{ub} and @{b}DFA.info@{ub} to @{b}DEVS:Datatypes@{ub} and the file @{b}dfa.datatype@{ub} to
  73. @{b}SYS:Classes/Datatypes@{ub}. That's it.
  74.    Of course, you may use the supplied installer script, as long as you
  75. have the installer executable installed.
  76. @EndNode
  77. @Node "Config" "DFADT.guide/Config"
  78. @Toc "Main"
  79. Minimum configuration
  80. *********************
  81.    Due to the fact that datatypes have been introduced to the Amiga OS
  82. with version 3.0 (v39), OS3.0 or better is needed to use the DFA
  83. datatype.
  84.    If you want to do @{b}more@{ub} than just to view existing address files,
  85. take a look at the DFA package (see @{"Commercial" Link "Commercial"} for details).
  86. @EndNode
  87. @Node "Usage" "DFADT.guide/Usage"
  88. @Toc "Main"
  89. Using the DFA datatype
  90. **********************
  91.    As soon as you've installed the datatype as described above (see
  92. @{"Installation" Link "Installation"}), you may start e.g. @{b}Multiview@{ub} and select a DFA address
  93. file to view it. At this time the datatype uses its builtin defaults
  94. for the display format.
  95.    The display format can be changed! See @{"Customizing the DFA datatype" Link "Customizing"}
  96. for details.
  97. @EndNode
  98. @Node "Customizing" "DFADT.guide/Customizing"
  99. @Toc "Main"
  100. Customizing the DFA datatype.
  101. *****************************
  102.    As mentioned above (@{"Using the DFA datatype" Link "Usage"}), the display format of
  103. the address can be changed.
  104.    This is done by a preferences file called @{b}ENV:DFADT.prefs@{ub} and
  105. @{b}ENVARC:DFADT.prefs@{ub} respectively. This file is read line by line, each
  106. line customizing a column of the display.
  107.    Every line must have exactly 3 parameters:
  108.   1. The @{b}name@{ub} of the field you want to display.
  109.   2. The description of the field to display. This may either be
  110.      something like " Phone: ", or simply " ". Please notice that the
  111.      different columns don't have any spacing automatically! So, if you
  112.      don't want to have the columns "merged" together, set the
  113.      description field at least to " ".
  114.   3. The length of the field, i.e. the width of the column (not counting
  115.      the descriptive text).
  116.    The following fields are available:
  117.    @{b}*@{ub} SALUTATION
  118.    @{b}*@{ub} FIRSTNAME
  119.    @{b}*@{ub} NAME
  120.    @{b}*@{ub} CO
  121.    @{b}*@{ub} STREET
  122.    @{b}*@{ub} ZIP
  123.    @{b}*@{ub} CITY
  124.    @{b}*@{ub} STATE
  125.    @{b}*@{ub} COUNTRY
  126.    @{b}*@{ub} BIRTHDAY
  127.    @{b}*@{ub} PHONE
  128.    @{b}*@{ub} FAX
  129.    @{b}*@{ub} EMAIL1
  130.    @{b}*@{ub} EMAIL2
  131.    @{b}*@{ub} EMAIL3
  132.    @{b}*@{ub} COMMENT
  133.    All field names are @{b}not@{ub} case sensitive.
  134. @EndNode
  135. @Node "MagicWB" "DFADT.guide/MagicWB"
  136. @Toc "Main"
  137. Notes on MagicWB
  138. ****************
  139.    As stated above some icons were taken from the MagicWB distribution,
  140. created by Martin 'XEN' Huttenloher. Most of you might already know
  141. MagicWB. If so, you may skip this part. This is only for newbies.
  142.    MagicWB is a special set of icons, fonts and patterns for an 8 color
  143. Workbench, which will give a very impressive and professional look to
  144. your Workbench. Due to the fact that MagicWB icons rely on an 8 color
  145. Workbench and a special set of color settings you might have noticed
  146. that the icons look kind of strange on your normal setup.
  147.    I strongly recommend that you get hold of MagicWB. It`s simply great.
  148. @EndNode
  149. @Node "Thanks" "DFADT.guide/Thanks"
  150. @Toc "Main"
  151. Whom I must say 'thank you'
  152. ***************************
  153.    I would like to thank the following people
  154. Olaf 'Olsen' Barthel
  155.      For giving the final motivation for the DFA datatype by his article
  156.      "Typen gibt's - Datatype selbstgemacht".
  157. Martin 'XEN' Huttenloher
  158.      For the MagicWB icons.
  159. Kai Iske
  160.      For the allowance to adopt his @{b}ForceIcon@{ub} documentation as a
  161.      skeleton for this manual.
  162. Stefan Ruppert
  163.      For his 'man' datatype, especially the source of it.  I adopted
  164.      some parts of it, when I started to program the DFA datatype.
  165.      ...and all the others I forgot
  166. @EndNode
  167. @Node "UpDates" "DFADT.guide/UpDates"
  168. @Toc "Main"
  169. How to obtain updates
  170. *********************
  171.    The DFA datatype will be available on ADS, FRAS, FTP, and Fred Fish
  172. disks (CDs) as soon as there is a new release available.
  173. @EndNode
  174. @Node "Address" "DFADT.guide/Address"
  175. @Toc "Main"
  176. How to contact the author
  177. *************************
  178.    If you have any questions, suggestions, bug reports or anything else
  179. you want to tell me, you may contact me under one of these addresses.
  180.    Either use normal snail mail:
  181.      Dirk Federlein
  182.      Brunnengasse 11a
  183.      63741 Aschaffenburg
  184.      Germany
  185.      Tel.: +49-(0)6021-87123
  186.    or reach me using electronical mail
  187.      USENET:     dirkf@alcmy.franken.de
  188.      COMPUSERVE: Dirk Federlein, 100577,1027
  189.      FIDO:       Dirk Federlein, 2:244/6302.12
  190. @EndNode
  191. @Node "Commercial" "DFADT.guide/Commercial"
  192. @Toc "Main"
  193. We got to do a commercial, now, kids. See you after these messages
  194. ******************************************************************
  195.    As noticed above, this datatype can be used to display files created
  196. by the DFA address utility, written by myself:
  197. @{b}DFA V2.2@{ub}
  198.      DFA is the definite address tool for you and the Amiga computer.
  199.      DFA supports email addresses, dialing of phone numbers, grouping of
  200.      addresses, different types of printing addresses, online help,
  201.      application icon/window and much more!
  202.      DFA has an Arexx port, font sensitive windows and can be fully
  203.      directed by keyboard.  Native languages are supported as soon as
  204.      Workbench 2.1 (and above) is installed.
  205.      DFA supplies a client server concept which makes the memory usage
  206.      as low as possible and gives you a very powerful tool to store
  207.      your addresses.
  208.      Nearly every aspect of DFA is customizable by an external
  209.      preferences program, so you may configure "your own" DFA.
  210.    DFA may be found on AmiNet or on Fish Disks/CDs.
  211. @EndNode
  212. @Node "History" "DFADT.guide/History"
  213. @Toc "Main"
  214. Program history
  215. ***************
  216.      ------------------------------------------------------------
  217.      Version 39.1                            (22.03.95 09:53:20)
  218.      ------------------------------------------------------------
  219.      
  220.           - Further memory optimization - only fields find their way
  221.             to address nodes that are really used later.
  222.             (Report: Kai Iske)
  223.      
  224.           - Optimized memory usage. Is is (nearly) fully dynamic now.
  225.             (Request: Kai Iske)
  226.      
  227.             --- Initial release ---
  228. @EndNode
  229.